home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / spitfire / page15.zip / PAGE.DOC < prev    next >
Text File  |  1996-02-12  |  7KB  |  176 lines
  1.                                 PAGE.DOC
  2.                   Running Page.exe with SPITFIRE V3.5 or 3.51
  3.  
  4.                            PAGE - Version 1.5 by
  5.                           Jeremy Kettelhohn, 1995
  6.                             A JMP Production
  7.  
  8.  
  9.  
  10. INTRO.
  11.  
  12. I wrote this program out of frustration that I kept forgetting to turn my page
  13. on or off.  I couldn't find a program or anything in spitfire that I could 
  14. schedule the page to be turned on or off.  So we scrapped a couple of projects 
  15. and turned to writing this program.  This program is not very complex.  Most 
  16. of the code is to attempt to make it Idiot Proof.  There are still places
  17. where things could go wrong like PAGE.CFG and TIMES.DAT are setup wrong.  This
  18. program is freeware because anyone with any PASCAL programming I'm 
  19. sure could write this just as easy as I did.  If anyone is interested in
  20. seeing the source code or would like the source code contact me.  I'm sure
  21. someone could easily clean up the code make it more efficient, and better to
  22. suit there needs.  I wrote it to suit my needs.  But will make changes so any
  23. SPITFIRE BBS can run it.  Also thanks to Mike Woltz who wrote what I think to
  24. be the best bbs software in the world.  Also thanks to Mike for releasing
  25. certain aspects of SPITFIRE that made this program possible.  I also include 
  26. the source so if someone would like to recompile and have output telling the 
  27. sysop that it ran okay.  If there is a problem when it runs it beeps and 
  28. writes to a file called errorlog.  If you can't get the error to work itself
  29. out please contact me and i'll help you out.
  30.  
  31.  
  32. RUNNING PAGE WITH SPITFIRE v3.5 or V3.51 WITHOUT FRONT DOOR UTILITY
  33.  
  34. The easiest way to run page within spitfire, is to have it placed before 
  35. spitfire is loaded.  The reason I recomend this is on how spitfire determines
  36. when the page is on or off.  If it is before your command to call spitfire it
  37. will even turn the page on and off after a user has exited a door.  See the
  38. example below.  My recomendation is not mandetory. But it will not work in
  39. the SFLOGON.BAT file.  If you still don't want to place it before spitfire
  40. is loaded I suggest placing it in your SFINIT.BAT
  41.  
  42. {EXAMPLE}
  43.  :LOOP
  44.    c:
  45.    CD\spitfire\Page
  46.    Page   or {optional  Page page.cfg}
  47.    CD\Spitfire
  48.    Echo Booting SPITFIRE Bulletin Board System
  49.    SPITFIRE /C0 0
  50.  
  51.  
  52. RUNNING PAGE WITH SPITFIRE V3.5 OR V3.51 WITH A FRONT DOOR UTILITY
  53.  
  54. For those of you running a Front Door utility I recommend the followin.
  55. I recomend to call page before you load spitfire.  Yes it works that way
  56. even if you are passing parameters.  In the Example below is how I call
  57. spitfire from my EXEBBS.BAT file.  I don't know enough about other Front
  58. Door utilities to recommend on how to run it.  I use Front Door V 2.20.
  59. If you are having trouble please contact me via one of my listed support
  60. areas.
  61.  
  62. {EXAMPLE}
  63. :LOOP
  64.    C:
  65.    cd\spitfire\page
  66.    rem page page.cfg
  67.    CD\Spitfire
  68.    ECHO LOADING SPITFIRE BULLETIN BOARD SYSTEM
  69.    SPITFIRE.EXE %1 /C1  /T%3
  70.    GOTO CONT
  71.  
  72. As you can see I pass with no problems from Front door Three parameters.  
  73.  
  74.  
  75. INSTALLING PAGE
  76.  
  77. The only thing you need to run this is PAGE.EXE, PAGE.CFG, and 
  78. TIMES.DAT.  These can be in there own directory if you wish or in the 
  79. SPITFIRE system directory.
  80.  
  81.  
  82.  
  83. SETTING UP PAGE.CFG
  84.  
  85. This is the easiest part. Use your favorite ASCII text editor to edit PAGE.CFG
  86.     Sample PAGE.CFG with Comments.
  87.  
  88. C:\SF\Page   {This line tells Page where to look for Its files or Times.dat}
  89. C:\SF\                {This Line tells Page where Spitfire System Files are}
  90.  
  91. In future versions since I only use two lines from Page.cfg I may make them 
  92. Command line Parameters.
  93.  
  94.  
  95. SETTING UP TIMES.DAT
  96.  
  97. This is a little harder.  The longer your Times.dat is the longer it may take
  98. to finish the program.  I would suspect that the file would have to be pretty
  99. long and on a slow computer before a noticeable wait occurs.
  100.     Sample TIMES.DAT
  101.  
  102. Monday 11:00 PM off
  103. Tuesday 8:00 am on
  104. Wednesday 10:00 am on
  105. Tuesday 5:00 PM off
  106.  
  107. The only absolute musts of TIMES.DAT that must be followed for now are 
  108. that after the day of the week there must be a space.  There must be a : 
  109. between the hour and Minute, and there must be spaces separating the 
  110. AM/PM and the status of the page.
  111. There is no requirement for the order that the days are listed.  It just
  112. trudges through the TIMES.DAT file and checks each line.  But it takes the
  113. last Day, Time and Status for the page.  So if you had.
  114.  
  115.      Tuesday 7:00 am on
  116.      Tuesday 8:00 am off
  117.      Tuesday 7:30 am on
  118.  
  119. If Page was ran on Tuesday After 8:00 AM it would be on at the end of the 
  120. program.  It will be On because the last thing it checked was that on Tuesday 
  121. at 7:30 am it was suppose to be on.  
  122.  
  123. Another problem encountered during testing was that if the day of the week 
  124. was not spelled right it would ignore that day.  So if you misspelled 
  125. Wednesday as Wednsday it would not do anything for that line.
  126.  
  127. A short coming of the program is that if a user calls one minute before the 
  128. page is to be turned off it won't be.  I currently don't shut off the page if
  129. the time to turn it on or off is close.  Future versions may allow for the
  130. user to specify a leeway of time that they would like the program to turn on
  131. and off the page if it is say 15 minutes away.
  132.  
  133.  
  134. RUNNING PAGE
  135.  
  136. Currently to run page is no problem.  If your PAGE.CFG and TIMES.DAT are 
  137. in the same directory as Page then all you need to do is put the following in
  138. a batch file or from the DOS prompt.
  139.  
  140. CD\SF\PAGE
  141. PAGE 
  142.  
  143. If your config is in a different directory from page please call page like the
  144. following. 
  145.  
  146. Page Page.cfg
  147.  
  148. That's it!  It should run and change your Page in SPITFIRE.  No more 
  149. forgetting to turn your page on and off it will do it for you if you put the
  150. day time and if you want it turned on or off.
  151.  
  152.  
  153. PROBLEMS
  154.  
  155. Pretty easy right.  If not give me a call on my bbs {IF its up} or a Voice
  156. call and we'll se if we can't fix your problem.  I can also be reached via
  157. Fidonet and Internet Mail.
  158.  
  159. Internet Mail
  160. jjkettel@alpha.delta.edu
  161.  
  162. Fido-net
  163. I check the Spitfire conferences quite often or the Pascal and Door Games 
  164. conference.  I would only use Fido-net if you can't afford to call me or if you 
  165. don't have access to Internet Mail.
  166.  
  167. Sloth Stone BBS
  168. (517)839-0532   
  169. {Currently operational sporadically.  Hoping to get it up full time again soon}
  170. Voice line if the bbs is not up is (517)839-0532
  171.  
  172. SPITFIRE.EXE, SFINIT.BAT, SF.BAT Are copyrighted
  173. by Mike Woltz 187-1995
  174.  by Buffalo Creek Software
  175.  
  176.